home *** CD-ROM | disk | FTP | other *** search
/ SGI Performance Co-Pilot 1.3 / SGI Performance Co-Pilot 1.3.iso / dist / pcp.idb / usr / share / catman / u_man / cat1 / pmafm.z / pmafm
Text File  |  1997-04-03  |  7KB  |  199 lines
  1.  
  2.  
  3.  
  4. PPPPMMMMAAAAFFFFMMMM((((1111))))                                                              PPPPMMMMAAAAFFFFMMMM((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppmmmmaaaaffffmmmm - Performance Co-Pilot archive folio manager
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ppppmmmmaaaaffffmmmm _f_o_l_i_o_n_a_m_e [_c_o_m_m_a_n_d [_a_r_g ...]]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      A collection of one or more Performance Co-Pilot (PCP) archive logs may
  16.      be combined with a control file to produce a PCP archive folio.  Archive
  17.      folios are created using either mmmmkkkkaaaaffff(1) or the interactive ``record
  18.      mode'' services of PCP clients like ppppmmmmcccchhhhaaaarrrrtttt(1).
  19.  
  20.      ppppmmmmaaaaffffmmmm provides a number of services that may be used to process folios.
  21.      In particular, it provides support for execution of PCP tools using one
  22.      or more of the component archive logs within an archive folio.
  23.  
  24.      The target folio is identified by the folio control file _f_o_l_i_o_n_a_m_e.  The
  25.      syntax for a folio control file is described in mmmmkkkkaaaaffff(1).
  26.  
  27.      If present, the command and arguments following _f_o_l_i_o_n_a_m_e are interpreted
  28.      and executed as a single command, otherwise commands are read from
  29.      standard input.
  30.  
  31.      The following commands are supported.
  32.  
  33.      aaaarrrrcccchhhhiiiivvvveeeessss
  34.           Subsequent commands apply to all archives in the folio.
  35.  
  36.      aaaarrrrcccchhhhiiiivvvveeeessss _N[,...]
  37.           Archives within a folio are numbered 1, 2, etc.  Subsequent commands
  38.           are restricted to apply only to the designated archives.
  39.  
  40.      aaaarrrrcccchhhhiiiivvvveeeessss _n_a_m_e[,...]
  41.           Archives within a folio have unique names.  Subsequent commands are
  42.           restricted to apply only to the designated archives.
  43.  
  44.      cccchhhheeeecccckkkk
  45.           Validate the presence and format of each file in the folio and the
  46.           component archives.
  47.  
  48.      hhhheeeellllpppp
  49.           A brief reminder of the command syntax.  ???? is a synonym for hhhheeeellllpppp.
  50.  
  51.      hhhhoooossssttttssss
  52.           Subsequent commands apply to all archives in the folio.
  53.  
  54.      hhhhoooossssttttssss _h_o_s_t_n_a_m_e[,...]
  55.           Subsequent commands are restricted to apply only to those archives
  56.           that match the designated hostnames.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PPPPMMMMAAAAFFFFMMMM((((1111))))                                                              PPPPMMMMAAAAFFFFMMMM((((1111))))
  71.  
  72.  
  73.  
  74.      lllliiiisssstttt [vvvveeeerrrrbbbboooosssseeee]
  75.           Display the contents of the folio.  By default the control header
  76.           and the ordinal number, hostname and archive base name for each
  77.           archive in the folio.  The vvvveeeerrrrbbbboooosssseeee option causes ppppmmmmaaaaffffmmmm to dump the
  78.           label record from each archive using ppppmmmmdddduuuummmmpppplllloooogggg ----llll.
  79.  
  80.      qqqquuuuiiiitttt
  81.           Exit ppppmmmmaaaaffffmmmm.
  82.  
  83.      rrrreeeemmmmoooovvvveeee
  84.           Echo on standard output the sssshhhh(1) commands required to remove all of
  85.           the physical files associated with this archive folio.
  86.  
  87.      rrrreeeeppppeeeeaaaatttt _t_o_o_l [_a_r_g ...]
  88.           Execute the known PCP _t_o_o_l once per selected archive.  For example,
  89.           the command
  90.                repeat pmval -t60 irix.kernel.all.load
  91.           would run ppppmmmmvvvvaaaallll(1) once per archive, with an appropriate ----aaaa
  92.           argument.
  93.  
  94.      rrrreeeeppppllllaaaayyyy
  95.           Some archive folios are created by tools (e.g. ppppmmmmcccchhhhaaaarrrrtttt(1)) that
  96.           provide sufficient information to allow all of the information in
  97.           all of the archives of a folio to be replayed.
  98.  
  99.      [rrrruuuunnnn] _t_o_o_l [_a_r_g ...]
  100.           Execute the known PCP _t_o_o_l on the selected archives.  Some PCP tools
  101.           are able to process multiple concurrent archives, and in this case
  102.           the the tool is run once with the list of all selected archives
  103.           passed via a ----aaaa argument.  Otherwise, this command is synonymous
  104.           with rrrreeeeppppeeeeaaaatttt.
  105.  
  106.      sssseeeelllleeeeccccttttiiiioooonnnnssss
  107.           Display those archives that would be selected for processing with a
  108.           rrrreeeeppppeeeeaaaatttt, rrrreeeeppppllllaaaayyyy or rrrruuuunnnn command.
  109.  
  110.      The restrictions via any hhhhoooossssttttssss and aaaarrrrcccchhhhiiiivvvveeeessss commands are conjuncted.
  111.      These restrictions serve to limit the specific archives processed in the
  112.      subsequent rrrreeeeppppeeeeaaaatttt, rrrreeeeppppllllaaaayyyy, rrrruuuunnnn and sssseeeelllleeeeccccttttiiiioooonnnnssss commands.  By default, all
  113.      archives are selected.
  114.  
  115.      Keywords in commands may be abbreviated provided no ambiguity is
  116.      introduced, e.g.  hhhheeeellllpppp, hhhheeeellll and hhhheeee are synonymous, but hhhh is ambiguous.
  117.  
  118. FFFFIIIILLLLEEEESSSS
  119.      ////vvvvaaaarrrr////ppppccccpppp////ccccoooonnnnffffiiiigggg////ppppmmmmaaaaffffmmmm////* control files that define the behavior of each
  120.                              PCP tool known to ppppmmmmaaaaffffmmmm.  This information may be
  121.                              customized or extended, see
  122.                              /_v_a_r/_p_c_p/_c_o_n_f_i_g/_p_m_a_f_m/_p_c_p for documentation of
  123.                              the syntax and semantics of these files.
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. PPPPMMMMAAAAFFFFMMMM((((1111))))                                                              PPPPMMMMAAAAFFFFMMMM((((1111))))
  137.  
  138.  
  139.  
  140. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  141.      mmmmkkkkaaaaffff(1) and ppppmmmmcccchhhhaaaarrrrtttt(1).
  142. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  143.      Many, but all are intended to be easily understood.
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.